Skip Headers

Oracle® Database Companion CD Installation Guide 10g Release 2 (10.2) for hp-ux Itanium Part Number B25297-01 |
Home | Book List | Contents | Index | Master Index | Feedback

Previous | Next
| View PDF

# 2 Oracle Database Companion CD Requirements

This chapter describes the requirements for installing the products from the Oracle Database 10g Companion CD installation media. It contains the following sections:

- Hardware and Software Certification

- General Requirements for Installing Oracle Software

- Requirements for Installing Oracle HTML DB Products

- Requirements for Installing Oracle Database 10g Products

- Requirements for Installing Oracle Database 10g Companion Products

- Network Setup

## 2.1 Hardware and Software Certification

The platform-specific hardware and software requirements included in this installation guide were current at the time this guide was published. However, because new platforms and operating system software versions may be certified after this guide is published, you must review the certification information on the OracleMetaLink Web site. This Web site provides the most up-to-date list of certified hardware platforms and operating system versions. You can visit the OracleMetaLink Web site at

`https://metalink.oracle.com`

If you do not have a current Oracle Support Services contract, then you can access the same information on the Oracle Technology Network Web site at

`http://www.oracle.com/technology/support/metalink/content.html`

## 2.2 General Requirements for Installing Oracle Software

The following sections describe the general requirements for installing Oracle software:

- Logging In to the System as root

- Required Symbolic Links

- Required Operating System Group and User

- Required Software Directories

- Configuring the oracle User's Environment

### 2.2.1 Logging In to the System as root

Before you install Oracle software, you must complete several tasks as the `root` user. To log in as the `root` user, complete one of the following procedures:

Note: Unless you intend to complete a silent installation, you must install the software from an X Window System workstation, an X terminal, or a PC or other system with X server software installed.

- If you are installing the software from an X Window System workstation or X terminal, then:

  1. Start a local terminal session, for example, an X terminal (`xterm`).

  2. If you are not installing the software on the local system, then enter the following command to enable the remote host to display X applications on the local X server:

         $ xhost fully_qualified_remote_host_name

  3. If you are not installing the software on the local system, then use the `ssh`, `rlogin`, or `telnet` command to connect to the system on which you want to install the software:

         $ telnet remote_host

  4. If you are not logged in as the `root` user, then enter the following command to switch user to `root`:

         $ su - root

- If you are installing the software from a PC or other system with X server software installed, then:

  Note: If required, refer to your X server documentation for more information about completing this procedure. Depending on the X server software that you are using, you may need to complete the tasks in a different order.

  1. Start the X server software.

  2. Configure the security settings of the X server software to permit remote hosts to display X applications on the local system.

  3. Connect to the remote system on which you want to install the software and start a terminal session on that system, for example, an X terminal (`xterm`).

  4. If you are not logged in as the `root` user on the remote system, then enter the following command to switch user to `root`:

         $ su - root

### 2.2.2 Required Symbolic Links

Note: This task is required only if the Motif 2.1 Development Environment package (X11MotifDevKit.MOTIF21-PRG) is not installed.

To enable you to successfully relink Oracle products after installing this software, enter the following commands to create required X library symbolic links in the `/usr/lib` directory:

    # cd /usr/lib
    # ln -s libX11.3 libX11.so
    # ln -s libXIE.2 libXIE.so
    # ln -s libXext.3 libXext.so
    # ln -s libXhp11.3 libXhp11.so
    # ln -s libXi.3 libXi.so
    # ln -s libXm.4 libXm.so
    # ln -s libXp.2 libXp.so
    # ln -s libXt.3 libXt.so
    # ln -s libXtst.2 libXtst.so

### 2.2.3 Required Operating System Group and User

Depending on whether this is the first time Oracle software is being installed on this system and on the products that you are installing, you may need to create the following operating system group and user:

- Oracle Inventory group (typically, `oinstall`)

  You must create the Oracle Inventory group the first time you install Oracle software on the system. The usual name chosen for this group is `oinstall`. This group owns the Oracle inventory, which is a catalog of all Oracle software installed on the system.

  Note: If Oracle software is already installed on the system, then the existing Oracle Inventory group must be the primary group of the operating system user that you use to install new Oracle software.

- Oracle software owner user (typically, `oracle`)

  You must create the Oracle software owner user the first time you install Oracle software on the system. This user owns all of the software installed during a given installation. This user must have the Oracle Inventory group as its primary group.

  Note: In Oracle documentation, the Oracle software owner user is referred to as the `oracle` user.

A single Oracle Inventory group is required for all installations of Oracle software on the system. After the first installation of Oracle software, you must use the same Oracle Inventory group for all subsequent Oracle software installations on that system. However, you can choose to create different Oracle software owner users for different installations.

Note: As an alternative to creating local users and groups, you can create the appropriate users and groups in a directory service. For example, Network Information Services (NIS). Contact your system administrator or refer to your operating system documentation for information about using directory services.

The following sections describe how to create the Oracle Inventory group and the Oracle software owner user:

- Oracle Inventory Group

- Oracle Software Owner User

#### 2.2.3.1 Oracle Inventory Group

If Oracle software is already installed on the system, then the existing Oracle Inventory group must be the primary group of the operating system user that you use to install new Oracle software. The following sections describe how to identify an existing Oracle Inventory group and, if required, to create it.

Determining If the Oracle Inventory Group Exists

When you install Oracle software on the system for the first time, Oracle Universal Installer creates the `oraInst.loc` file. This file identifies the name of the Oracle Inventory group and the path of the Oracle Inventory directory. To determine if the Oracle Inventory group exists, enter the following command:

    # more /var/opt/oracle/oraInst.loc

If the output of this command shows the `oinstall` group name, then the group already exists.

If the `oraInst.loc` file exists, then the output from this command is similar to the following:

    inventory_loc=/u01/app/oracle/oraInventory
    inst_group=oinstall

The `inst_group` parameter shows the name of the Oracle Inventory group, `oinstall`.

Creating the Oracle Inventory Group

Note: Oracle recommends that you use the group name `oinstall` for the Oracle Inventory group.

If the `oraInst.loc` file does not exist, then enter the following command to create the oinstall group:

    # /usr/sbin/groupadd oinstall

#### 2.2.3.2 Oracle Software Owner User

You must create an Oracle software owner user if any of the following conditions is true:

- An Oracle software owner user does not exist; for example, if this is the first installation of Oracle software on the system.

- An Oracle software owner user exists, but you want to use a different operating system user.

Note: In this document, the Oracle software owner user is referred to as `oracle`.

Determining If an Oracle Software Owner User Exists

To determine if an Oracle software owner user named `oracle` exists, enter the following command:

    # id oracle

If the `oracle` user exists, then the output from this command is similar to the following:

    uid=440(oracle) gid=200(oinstall) groups=201(dba),202(oper)

If the user exists, then determine whether you want to use the existing user or create a user. If you want to use the existing user, then ensure that the user's primary group is the Oracle Inventory group.

Refer to one of the following sections for more information:

Note: If necessary, contact your system administrator before using or modifying an existing user.

- If you want to use the existing Oracle software owner user, and the user's primary group is the Oracle Inventory group, then refer to the "Required Software Directories" section.

- To modify an existing user, refer to the "Modifying an Existing Oracle Software Owner User" section.

- To create a user, refer to the following section.

Creating an Oracle Software Owner User

If the Oracle software owner user does not exist or if you require a new Oracle software owner user, then create it as follows:

Note: In the following procedure, use the user name `oracle` unless a user with that name already exists.

1. To create the `oracle` user, enter a command similar to the following:

       # /usr/sbin/useradd -g oinstall[ -G dba] oracle

   In this command:

   - The `-g` option specifies the primary group, which must be the Oracle Inventory group, for example `oinstall`.

   - The `-G` option specifies optional secondary groups.

2. Set the password of the `oracle` user as follows:

       # passwd oracle

To continue, refer to the "Required Software Directories" section.

Modifying an Existing Oracle Software Owner User

If the `oracle` user exists, but its primary group is not `oinstall`, then enter a command similar to the following, specifying the primary group using the `-g` option and any required secondary groups using the `-G` option:

    # /usr/sbin/usermod -g oinstall -G dba oracle

### 2.2.4 Required Software Directories

This section describes the following directories, which you must identify or create for the Oracle software:

- Oracle Base Directory

- Oracle Inventory Directory

- Oracle Home Directory

Oracle Base Directory

The Oracle base directory acts as a top-level directory for Oracle software installations. It is analogous to the `C:\Oracle` directory used for Oracle software installations on Microsoft Windows systems. On UNIX-based systems, the Optimal Flexible Architecture (OFA) guidelines recommend that you use a path similar to the following for the Oracle base directory:

    /mount_point/app/oracle_sw_owner

In this example:

- `mount_point` is the mount point directory for the file system that will contain the Oracle software.

  The examples in this guide use `/u01` for the mount point directory. However, you can choose another mount point directory. For example, `/oracle` or `/opt/oracle`.

- `oracle_sw_owner` is the operating system user name of the Oracle software owner, for example `oracle`.

You can use the same Oracle base directory for more than one installation or you can create separate Oracle base directories for different installations. If different operating system users install Oracle software on the same system, then each user must create a separate Oracle base directory. For example, the following Oracle base directories can exist on the same system at the same time:

    /u01/app/oracle
    /u01/app/orauser
    /opt/oracle/app/oracle

Regardless of whether you create an Oracle base directory or decide to use an existing one, you must set the `ORACLE_BASE` environment variable to specify the full path to this directory.

Note: You can create an Oracle base directory even if other Oracle base directories exist on the system.

Identifying an Existing Oracle Base Directory

Existing Oracle base directories may not have paths that comply with Oracle Flexible Architecture (OFA) guidelines. However, if you identify an existing Oracle Inventory directory or existing Oracle home directories, then you can usually identify the Oracle base directories, as follows:

- Identify an existing Oracle Inventory directory

  Enter the following command to view the contents of the `oraInst.loc` file:

      # more /var/opt/oracle/oraInst.loc

  If the `oraInst.loc` file exists, then the output from this command is similar to the following:

      inventory_loc=/u01/app/oracle/oraInventory
      inst_group=oinstall

  The `inventory_loc` parameter identifies the Oracle Inventory directory (`oraInventory`). The parent directory of the `oraInventory` directory is typically an Oracle base directory. In the previous example, `/u01/app/oracle` is an Oracle base directory.

- Identifying existing Oracle home directories

  Enter the following command to view the contents of the `oratab` file:

      # more /etc/oratab

  If the `oratab` file exists, then it contains lines similar to the following:

      *:/u03/app/oracle/product/10.2.0/db_1:N
      *:/opt/orauser/infra_904:N
      *:/oracle/9.2.0:N

  The directory paths specified on each line identify Oracle home directories. Directory paths that end with the user name of the Oracle software owner that you want to use are valid choices for an Oracle base directory. If you intend to use the `oracle` user to install the software, then you can choose one of the following directories from the previous example:

      /u03/app/oracle
      /oracle

  Note: If possible, choose a directory path similar to the first (`/u03/app/oracle`). This path complies with the OFA guidelines.

To continue:

- If an Oracle base directory exists and you want to use it, then refer to the "Configuring the oracle User's Environment" section.

  When you are configuring the `oracle` user's environment later in this chapter, set the `ORACLE_BASE` environment variable to specify the directory you chose.

- If an Oracle base directory does not exist on the system or if you want to create an Oracle base directory, then refer to the following section.

Creating an Oracle Base Directory

To identify an appropriate file system:

1. Use the `bdf` command to determine the free disk space on each mounted file system.

2. From the display, identify a file system that has sufficient free space.

3. Note the name of the mount point directory for the file system that you identified.

To create the Oracle base directory and specify the correct owner, group, and permissions for it:

1. Enter commands similar to the following to create the recommended subdirectories in the mount point directory that you identified and set the appropriate owner, group, and permissions for them:

       # mkdir -p /mount_point/app/oracle_sw_owner
       # chown -R oracle:oinstall /mount_point/app/oracle_sw_owner
       # chmod -R 775 /mount_point/app/oracle_sw_owner

   If the mount point you identified is `/u01` and `oracle` is the user name of the Oracle software owner, then the recommended Oracle base directory path is as follows:

       /u01/app/oracle

2. When you are configuring the `oracle` user's environment later in this chapter, set the `ORACLE_BASE` environment variable to specify this directory.

Oracle Inventory Directory

The Oracle Inventory directory (`oraInventory`) stores an inventory of all software installed on the system. It is required by, and shared by, all Oracle software installations on a single system. The first time you install Oracle software on a system, Oracle Universal Installer prompts you to specify the path to this directory. Oracle recommends that you choose the following path:

    oracle_base/oraInventory

Oracle Universal Installer creates the directory that you specify and sets the correct owner, group, and permissions on it. You do not need to create it.

Caution: All Oracle software installations rely on this directory. Ensure that you back it up regularly. Do not delete this directory unless you have completely removed all Oracle software from the system.

Oracle Home Directory

The Oracle home directory is the directory in which you choose to install the software for a particular Oracle product. You must install different Oracle products, or different releases of the same Oracle product, in separate Oracle home directories. When you run Oracle Universal Installer, it prompts you to specify the path to this directory, as well as a name that identifies it. The directory that you specify must be a subdirectory of the Oracle base directory. Oracle recommends that you specify a path similar to the following for the Oracle home directory:

    oracle_base/product/10.2.0/companion_1

Oracle Universal Installer creates the directory path that you specify under the Oracle base directory. It also sets the correct owner, group, and permissions on it. You do not need to create this directory.

### 2.2.5 Configuring the oracle User's Environment

You run Oracle Universal Installer from the `oracle` account. However, before you start Oracle Universal Installer, you must configure the environment of the `oracle` user. To configure the environment, you must:

- Set the default file mode creation mask (`umask`) to 022 in the shell startup file.

- Set the `DISPLAY` environment variable.

To set the `oracle` user's environment, follow these steps:

1. Start a new terminal session; for example, an X terminal (`xterm`).

2. Enter the following command to ensure that X Window applications running on the remote host can display on this system:

       $ xhost fully_qualified_remote_host_name

3. If you are not already logged in to the system on which you want to install the software, then log in to that system as the `oracle` user.

4. If you are not logged in as the `oracle` user, then switch user to `oracle`:

       $ su - oracle

5. To determine the default shell for the `oracle` user, enter the following command:

       $ echo $SHELL

6. Open the `oracle` user's shell startup file in any text editor:

   - Bash (`bash`) shell:

         $ vi .bash_profile

   - Bourne shell (`sh`), or Korn shell (`ksh`):

         $ vi .profile

   - C shell (`csh` or `tcsh`):

         % vi .login

7. Enter or edit the following line, specifying a value of `022` for the default file mode creation mask:

       umask 022

8. If the `ORACLE_SID`, `ORACLE_HOME`, or `ORACLE_BASE` environment variable are set in the file, then remove the appropriate lines from the file.

9. Save the file, and exit from the editor.

10. To run the shell startup script, enter one of the following commands:

    - Bourne or Korn shell:

          $ . ./.profile

    - C shell:

          % source ./.login

11. If you are not installing the software on the local system, then enter a command similar to the following to direct X applications to display on the local system:

    - Bourne, Bash, or Korn shell:

          $ DISPLAY=local_host:0.0 ; export DISPLAY

    - C shell:

          % setenv DISPLAY local_host:0.0

    In this example, `local_host` is the host name or IP address of the system you want to use to display Oracle Universal Installer (your workstation or PC).

12. If you determined that the `/tmp` directory has less than the required free disk space, then identify a file system with the required amount of free space and set the `TMP` and `TMPDIR` environment variables to specify a temporary directory on this file system. To do this:

    1. Use the `bdf` command to identify a suitable file system with sufficient free space.

    2. If necessary, enter commands similar to the following to create a temporary directory on the file system that you identified and to set the appropriate permissions on the directory:

           $ su - root
           # mkdir /mount_point/tmp
           # chmod a+wr /mount_point/tmp
           # exit

    3. Enter commands similar to the following to set the `TMP` and `TMPDIR` environment variables:

       - Bourne, Bash, or Korn shell:

             $ TMP=/mount_point/tmp
             $ TMPDIR=/mount_point/tmp
             $ export TMP TMPDIR

       - C shell:

             % setenv TMP /mount_point/tmp
             % setenv TMPDIR /mount_point/tmp

13. Enter the following command to ensure that the `ORACLE_HOME` and `TNS_ADMIN` environment variables are not set:

    - Bourne, Bash, or Korn shell:

          $ unset ORACLE_HOME
          $ unset TNS_ADMIN

    - C shell:

          % unsetenv ORACLE_HOME
          % unsetenv TNS_ADMIN

14. To verify that the environment has been set correctly, enter the following commands:

        $ umask
        $ env | more

    Verify that the `umask` command displays a value of `22`, `022`, or `0022` and the environment variables that you set in this section have the correct values.

## 2.3 Requirements for Installing Oracle HTML DB Products

When you install the Oracle HTML DB installation type, you can install Oracle HTML DB, Oracle HTTP Server, or Oracle HTML DB with Oracle HTTP Server.

Note: You must install the Oracle HTML DB Products in an Oracle home that is different from the Oracle home used for Oracle Database.

The requirements for the Oracle HTML DB Products installation type can be categorized as follows:

- Oracle HTTP Server Requirements

- Oracle HTML DB Requirements

### 2.3.1 Oracle HTTP Server Requirements

You must install Oracle HTTP Server in a new Oracle home. You can install Oracle HTTP Server more than once on the same system, as long as each installation uses a separate Oracle home directory.

Before you install Oracle HTTP Server in a new Oracle home, ensure that your system meets the following requirements:

- Oracle Database Requirement

- Hardware Requirements

- Software Requirements

#### 2.3.1.1 Oracle Database Requirement

Oracle HTTP Server must have access to an instance of Oracle9i Database release 9.2.0.3 or later in order to run. Oracle Database can be on a separate system from Oracle HTTP Server, as long as it is accessible by using Oracle*Net. However, Oracle HTTP Server must be in its own home.

For example, suppose Oracle Database is installed in `OraDB10g_Home1`. When you run Oracle Universal Installer to install Oracle HTML DB, you can specify the Oracle Database installed in `OraDB10g_Home1`. However, you need to install Oracle HTML DB in a different Oracle home that contains Oracle HTTP Server, for example, `OraDB10g_Home2`.

#### 2.3.1.2 Hardware Requirements

The system must meet the following minimum hardware requirements:

- 256 MB of physical RAM

- 512 MB of swap space

- 125 MB of free disk space in the `/tmp` directory

- 530 MB of free disk space for the software files

To ensure that the system meets these requirements:

1. To determine the physical RAM size, enter the following command:

       # /usr/contrib/bin/machinfo  | grep -i Memory

   If the size of the physical RAM installed on the system is less than the required size, then you must install more memory before continuing.

2. To determine the size of the configured swap space, enter the following command:

       # /usr/sbin/swapinfo -a

   If necessary, refer to your operating system documentation for information about how to configure additional swap space.

3. To determine the amount of free disk space in the `/tmp` directory, enter the following command:

       # bdf /tmp

   If there is less than 125 MB of free disk space in the `/tmp` directory, then complete one of the following steps:

   - Delete unnecessary files from the `/tmp` directory.

   - Set the `TMP` and `TMPDIR` environment variables when setting the `oracle` user's environment.

   - Extend the file system that contains the `/tmp` directory. If necessary, contact your system administrator for information about extending file systems.

4. To determine the amount of free disk space on the system, enter the following command:

       # bdf

5. To determine if the system architecture can run the software, enter the following command:

       # /bin/getconf KERNEL_BITS

   The expected output of this command is the processor type. Verify that the processor architecture matches the requirement for the current release.

   Note: If you do not see the expected output, then you cannot install the software on this system.

#### 2.3.1.3 Software Requirements

Verify that the following software is installed on the system. The procedure following the table describes how to check these requirements.

Item | Requirement
--- | ---
Operating system | Operating system version: HP-UX 11i v2 (11.23)
PL/SQL native compilation | One of the following: HP C/ANSI C Compiler (A.06.00) GCC compiler gcc 3.4.2 Note: The gcc compiler is supported only for PL/SQL native compilation.
Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK) | HP C/ANSI C Compiler (A.06.00) HP aC++ Compiler (A.06.00)
Oracle JDBC/OCI Drivers | You can use the following optional Java SDK versions with the Oracle JDBC/OCI drivers, however they are not required for the installation: HP JDK 1.5.0 (5.0) HP JDK 1.4.2.07 HP JDK 1.3.1.16 Note: Java SDK 1.4.2_07 is installed with this release.

To ensure that the system meets these requirements:

1. To determine the version of the operating system, enter the following command:

       # uname -a

   The following is sample output of this command:

       HP-UX hostname B.11.23 ia64 109444686 unlimited-user license

   In this sample output, the version shown is HP-UX 11i v2 (11.23). If necessary, refer to your operating system documentation for information about upgrading the operating system.

Checking for Required Patches

Note: The patch versions mentioned in the following table are minimum versions. Later versions of the same patches are also supported.

The following patches, or their later versions, are required:

Installation Type or Product | Requirement
--- | ---
All installations | The following operating system patches: BUNDLE11i B.11.23.0409.3: Patch Bundle for HP-UX 11i V2 Note: You must have the August 2004 version of BUNDLE11i B.11.23.0408.1 for HP-UX 11i v2 on your system prior to updating to the HP-UX 11i v2 September 2004 or later release. PHCO 32426: Reboot(1M) cumulative patch PHKL 32646: wsio.h header file patch PHKL 32632: Message Signaled Interrupts (MSI and MSI-X) PHKL 32645: SIO (IO) subsystem MSI/MSI-X/WC Patch PHKL 33552: VM Copy on write data corruption fix PHSS_31850: 11.23 assembler patch PHSS_31851: 11.23 Integrity Unwind Library PHSS_31854: 11.23 milli cumulative patch PHSS_31855: 11.23 aC++ Runtime (IA: A.05.60, PA A.03.60) PHSS_33275: 11.23 linker + fdp cumulative patch PHSS_33276: 11.23 Math Library Cumulative Patch
All installations | The following JDK patches: PHCO_31553: s700_800 11.23 pthread library cumulative patch PHKL_31500: s700_800 11.23 sept04 base patch PHSS_32213: s700_800 11.23 aries cumulative patch Note: Refer to the following Web site for information about additional patches that may be required by JDK 1.4.2: `http://www.hp.com/products1/unix/java/patches/index.html`
PL/SQL native compilation, Pro*C/C++, Oracle Call Interface, Oracle C++ Call Interface, Oracle XML Developer's Kit (XDK) | The following C and C++ patches: PHSS_33278: aC++ Compiler PHSS_33279: aC++ Compiler PHSS_33277: HP C Compiler PHSS_33279: HP C Compiler

To determine if a patch is installed, enter a command similar to the following:

    # /usr/sbin/swlist -l patch | grep PHSS_33279

Alternatively, to list all installed patches, enter the following command:

    # /usr/sbin/swlist -l patch | more

If a required patch is not installed, then download it from the following Web site and install it:

    http://itresourcecenter.hp.com

If the Web site shows a more recent version of the patch, then download and install that version.

### 2.3.2 Oracle HTML DB Requirements

The requirements for Oracle HTML DB are as follows:

- Oracle Database Requirement

- Disk Space Requirements

- Oracle HTTP Server Requirement

- Oracle XML DB Requirement

- Oracle Text Requirement

- Browser Requirements

#### 2.3.2.1 Oracle Database Requirement

Oracle HTML DB requires an installation of release 9.2.0.3 or later of Oracle Database. You must install Oracle HTML DB in an Oracle home that contains Oracle HTTP Server. This Oracle home, with both Oracle HTML DB and Oracle HTTP Server, is referred to as the Companion CD Oracle home. The Companion CD Oracle home can be on a different physical server from the Oracle Database home, as long as Oracle HTML DB can access this database by using Oracle*Net.

For example, suppose Oracle Database is installed in `OraDB10g_Home1`. When you run Oracle Universal Installer to install Oracle HTML DB, you can specify the Oracle Database installed in `OraDB10g_Home1`. However, you need to install Oracle HTML DB in a different Oracle home that contains Oracle HTTP Server, for example, `OraDB10g_Home2`.

During the installation, you must specify the following information about the database:

- The host name of the database system

- The port number of the Oracle Net listener

- The service name of the database

- The password of the `SYS` user

Ensure that you have this information before starting the installation.

#### 2.3.2.2 Disk Space Requirements

Verify that the file system in which the Oracle home is located contains at least 355 MB of free disk space.

To check that the Oracle home directory has enough space, enter the following command:

    # bdf /httpserver_oracle_home_path

#### 2.3.2.3 Oracle HTTP Server Requirement

Oracle HTML DB must have access to Oracle HTTP Server and `mod_plsql` in order to run. The following products include the versions of HTTP Server and `mod_plsql` that meet this requirement:

- Oracle9i Database release 2 (9.2) or later

- Oracle9i Application Server release 1 (1.0.2.2) or later

If the system does not meet these requirements, then you must install Oracle HTTP Server 10g when you install the Oracle Database 10g Companion Products.

#### 2.3.2.4 Oracle XML DB Requirement

Oracle XML DB must be installed in the database that you want to use. If you are using a preconfigured database created either during an installation or by running Oracle Database Configuration Assistant, then Oracle XML DB is already installed and configured.

See Also: Oracle XML DB Developer's Guide for information about manually adding Oracle XML DB to an existing database

#### 2.3.2.5 Oracle Text Requirement

Oracle Text must be installed so that you can use the searchable online Help in Oracle HTML DB. By default, Oracle Text is installed as part of Oracle Database.

In addition, ensure that the default language preferences for Oracle Text have been installed. To install the Oracle Text default language, run the appropriate `drdef` `lang``.sql` script (for example, `drdefus.sql` for US English) from the following directory:

    $ORACLE_HOME/ctx/admin/defaults

See Also : Oracle Text Application Developer's Guide for more information about Oracle Text

#### 2.3.2.6 Browser Requirements

To view or develop Oracle HTML DB applications, the Web browser you use must support JavaScript and the HTML 4.0 and CSS 1.0 standards. The following browsers meet this requirement:

- Netscape Communicator 7.0 or later

- Microsoft Internet Explorer 5.5 or later

- Mozilla 1.2 or later

- Mozilla Firefox 1.0 or later

## 2.4 Requirements for Installing Oracle Database 10g Products

The requirements for the Oracle Database 10g Products installation type are as follows:

- Oracle Database Requirement

- Disk Space Requirements

- Oracle Workflow Server Requirements

See Also: "Products Available in the Oracle Database 10g Companion Products Installation Type"

### 2.4.1 Oracle Database Requirement

Before you install products from the Oracle Database 10g Products installation type, you must ensure that your system has access to an Oracle Database 10g release 2 (10.2) Oracle home. If required, you must first install or upgrade to this release of Oracle Database.

See Also: Oracle Database Installation Guide for information about installing Oracle Database

Identify the Oracle home directory used by the Oracle Database installation. To do this, you can check the contents of the `oratab` file by using the following command:

    # more /etc/oratab

### 2.4.2 Disk Space Requirements

Verify that the file system that contains the Oracle home directory has at least 1194 MB of free disk space.

To check that the Oracle home directory has enough space, enter the following command:

    # bdf oracle_home_path

### 2.4.3 Oracle Workflow Server Requirements

Requirements for Oracle Workflow Server are as follows:

- A Web browser that supports frames, JavaScript, Java Development Kit (JDK) version 1.3.1, and AWT, such as Netscape Communicator version 4.76 or a later 4.7x version, or Microsoft Internet Explorer version 5.0x or 5.5x

- An unzip utility to extract the Workflow HTML Help from the `wfdoc.zip` file.

- Java Development Kit (JDK) version 1.4, to run the Oracle Workflow Java Function Activity Agent and the Workflow XML Loader.

- An outbound SMTP mail server and an inbound IMAP mail server, if you want to send and receive e-mail notifications using an Oracle Workflow notification mailer.

During the installation, you must specify the following information about the Oracle Database installation:

- Host name

- Port

- Service name

- User name and password of the Oracle Workflow Server (typically, `owf_mgr`)

## 2.5 Requirements for Installing Oracle Database 10g Companion Products

The Oracle Database 10g Companion Products installation type lets you install Oracle HTTP Server, Oracle Workflow middle-tier components, or both Oracle HTTP Server and Oracle Workflow middle-tier components. You must install these products in a separate Oracle home from Oracle Database.

The requirements for Oracle Workflow middle-tier components are as follows.

- Oracle Workflow Server Requirements

- Oracle HTTP Server Requirements

- Disk Space Requirements

### 2.5.1 Oracle Workflow Server Requirements

Before you install Oracle Workflow middle-tier components, you must verify that Oracle Workflow Server is installed in an Oracle Database 10g Oracle home. You can use Oracle Universal Installer to check the contents of an Oracle home. Alternatively, open the `/etc/oratab` file to see details of the Oracle homes created for the Oracle Database installation on the system.

If Oracle Workflow Server is not installed, then follow the instructions in this guide for installing Oracle Database 10g Products. After you install Oracle Workflow, you need to configure it by using Oracle Workflow Configuration Assistant.

See Also: "Installing Oracle Database 10g Products"

### 2.5.2 Oracle HTTP Server Requirements

Oracle Workflow middle-tier components need access to Oracle HTTP Server in order to run. You can install Oracle Workflow middle-tier components with Oracle HTTP Server in a new Oracle home directory. Alternatively, you can install this product in an existing Oracle HTTP Server Oracle home that contains Oracle HTTP Server with `mod_plsql`. Oracle home directories for the following products meet this requirement:

- Oracle HTTP Server 10g

- Oracle Identity Management 10g (part of Oracle Application Server 10g)

See Also: "Oracle HTTP Server Requirements" if you plan to use the Oracle HTTP Server available with this release of Oracle Database Companion CD

### 2.5.3 Disk Space Requirements

The disk space requirements for the Oracle Database 10g Companion Products are shown in the following table.

Products for Installation | Disk Space Required (MB)
--- | ---
Oracle HTTP Server | 2100
Oracle HTTP Server and Oracle Workflow | 2400

## 2.6 Network Setup

Typically, the computer on which you want to install Oracle Database is connected to the network, has local storage to contain the Oracle Database installation, has a display monitor, and has a CD-ROM or DVD drive.

This section describes how to install Oracle Database on computers that do not meet the typical scenario. It covers the following cases:

- Installing on DHCP Computers

- Installing on Multihomed Computers

- Installing on Computers with Multiple Aliases

### 2.6.1 Installing on DHCP Computers

Dynamic Host Configuration Protocol (DHCP) assigns dynamic IP addresses on a network. Dynamic addressing enables a computer to have a different IP address each time it connects to the network. In some cases, the IP address can change while the computer is still connected. You can have a combination of static and dynamic IP addressing in a DHCP system.

In a DHCP setup, the software tracks IP addresses, which simplifies network administration. This lets you add a new computer to the network without having to manually assign that computer a unique IP address.

### 2.6.2 Installing on Multihomed Computers

You can install Companion CD products on a multihomed computer. A multihomed computer is associated with multiple IP addresses. This is typically achieved by having multiple network cards on the computer. Each IP address is associated with a host name. In addition, you can set up aliases for the host name. By default, Oracle Universal Installer uses the `ORACLE_HOSTNAME` environment variable setting to find the host name. If `ORACLE_HOSTNAME` is not set and you are installing on a computer that has multiple network cards, then Oracle Universal Installer determines the host name by using the first entry in the `/etc/hosts` file.

Clients must be able to access the computer either by using this host name or by using aliases for this host name. To verify this, ping the host name from the client computers using the short name (host name only) and the full name (host name and domain name). Both tests must be successful.

Setting the ORACLE_HOSTNAME Environment Variable

Use the following procedure to set the `ORACLE_HOSTNAME` environment variable.

If, for example, the fully qualified host name is `somehost.us.acme.com`, then enter one of the following commands:

Bourne, Bash, or Korn shell:

    $ ORACLE_HOSTNAME=somehost.us.acme.com
    $ export ORACLE_HOSTNAME

C shell:

    % setenv ORACLE_HOSTNAME somehost.us.acme.com

### 2.6.3 Installing on Computers with Multiple Aliases

A computer with multiple aliases is registered with the naming service under a single IP but with multiple aliases. The naming service resolves any of those aliases to the same computer. Before installing Oracle Database on such a computer, set the `ORACLE_HOSTNAME` environment variable to the computer whose host name you want to use.